home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / mus / play / SPlayLib31.lha / superplay-lib / Docs / SuperPlay-Lib_ENG.doc < prev    next >
Text File  |  1994-07-21  |  7KB  |  216 lines
  1.  
  2.                       superplay.library V3.1
  3.  
  4.                            - FREEWARE -
  5.  
  6.              © 1994 by Andreas R. Kleinert. All rights reserved.
  7.  
  8.               This program was written under OS V3.00 and is therefore
  9.               fully compatible. It needs OS V2.04+.
  10.  
  11.               Release Date : 21.07.1994
  12.  
  13.  
  14.     Copyright :
  15.     ===========
  16.  
  17.     The program superplay.library V3.1 and its documentation files are
  18.     (C)opyright 1994 by Andreas R. Kleinert. All rights reserved.
  19.  
  20.     The usage of the "superplay.library" for own program projects, no
  21.     matter if commercial or non-commercial, is allowed without any
  22.     restrictions.
  23.  
  24.  
  25.     Disclaimer :
  26.     ============
  27.  
  28.     The author takes no responsibility for any results of the use of this
  29.     program.
  30.     This software is provided "AS IS" and there is no warranty of any kind,
  31.     so that you use this software at your own risk.
  32.  
  33.  
  34.     Functions :
  35.     ===========
  36.  
  37.     The "superplay.library" is used in many of my programs and it consists of
  38.     many functions, which make playing, saving and converting of various
  39.     sound formats (SoundTracker, MED, IFF-8SVX, VOC, ...) much easier.
  40.     External Player-Libraries (SPObjects) allow highest possible
  41.     flexibility and easy to do expansions.
  42.  
  43.     Just send me your own SPObjects if you want to have them added
  44.     to the main distribution archive or onto the developer disk.
  45.  
  46.  
  47.     Installation :
  48.     ==============
  49.  
  50.     Just copy the "superplay.library" into your "LIBS:"-directory.
  51.     Copy all the SPObjects to "LIBS:spobjects/".
  52.  
  53.  
  54.     Correspondence :
  55.     ================
  56.  
  57.     If you like, you may send me some money. Perhaps this will motivate me
  58.     to continue programming such programs or just making updates of
  59.     this one. Send bug-reports, money or whatever to :
  60.  
  61.        Andreas R. Kleinert,
  62.        Grube Hohe Grethe 23,
  63.        D-57074 Siegen,
  64.        Germany.                        email : Fido 2:2457/345.10
  65.                                                (checked weekly)
  66.  
  67.     Support :
  68.     =========
  69.  
  70.     The following programs are currently supporting the "superplay.library" :
  71.  
  72.      - SuperPlay
  73.      - SimplePlay
  74.      - ...
  75.  
  76.  
  77.     SPObjects :
  78.     ===========
  79.  
  80.      SVObject     Type       Formats                          Write
  81.  
  82.      ST           Module     SoundTracker, ProTracker, ...    -
  83.      MED          Module     MMD0                             -
  84.      8SVX         Sample     IFF-8SVX (unencoded)             Sample
  85.      VOC          Sample     PC VOC V1.10                     Sample
  86.      WAV          Sample     RIFF-WAVE (Windows)              Sample
  87.  
  88.  
  89.     Planned SVObjects (no guarantee !) :
  90.  
  91.      - OS V3.00+ DataTypes (Audio-DataTypes only)
  92.      - ...
  93.  
  94.  
  95.     Thanks and greetings to :
  96.     =========================
  97.  
  98.     in alphabetical order :)
  99.  
  100.     Alex    Carbin      (TuC / PowerBrei Red.),
  101.     Fred    Fish        (AmigaLibDisks),
  102.     Gerd    Frank       (BerndsPD),
  103.     Stefan  Grad        (GPD),
  104.     Stefan  Kremer      (TuC / PowerBrei Red.),
  105.     Alex    Lange       (Time PD-Serie),
  106.     H.P.    Lattka      (Franz PD-Serie),
  107.     Andreas Manewaldt   (Taifun PD-Serie),
  108.     Michael Petrikowski (Amiga Szene),
  109.  
  110.     and all I forgot !
  111.  
  112.  
  113.     History :
  114.     =========
  115.  
  116.      V3.1 (21.07.1994) :
  117.      -------------------
  118.  
  119.       - This is not really a bug-fix, but more an aditional feature :
  120.         increased Version to 3, because it was not save in V2.1 to pass
  121.         a NULL value for SuperWrite()'s "source_handle" parameter,
  122.         although this is supported by the V2 SPObjects (now).
  123.         If you plan to add this feature to your software, request at
  124.         least V3+ !
  125.  
  126.  
  127.      V2.1 (20.07.1994) :
  128.      -------------------
  129.  
  130.       - introduced "SampleLists" and added two new functions to superplay-
  131.         Library and Version 2 SPObjects for getting and setting of the
  132.         Lists. Added two Example-Programs which demonstrate usage of
  133.         SampleLists.
  134.       - re-arranged directory structure of most sub-dirs
  135.       - all NON-DISK loading and saving, e.g. from/into ClipBoard
  136.         DID NOT WORK.
  137.         Specifications had to be changed slightly - in a compatible way -
  138.         to re-arrange READING to work (see Reference-Docs,
  139.         SPL_InitHandleAsClip-Function).
  140.         For WRITING only superplay-Library had to be changed.
  141.         (This bug-fix has not yet been tested, since SuperPlay does not
  142.          support ClipBoard-Access, but it has been done the same way
  143.          as in superview.library, so it should work ...)
  144.       - ST.spobject and MED.spobject now allow extraction of Samples
  145.         of Modules
  146.         (see example-programs "SampleListDemo" and "SampleListPlay")
  147.       - fixed bad bug in ST.spobject's file-recognition (see there)
  148.  
  149.  
  150.      V1.6 (02.07.1994) :
  151.      -------------------
  152.  
  153.       - new version of SuperPlay (GUI improved)
  154.       - changes to ST.spobject and WAV.spobject
  155.       - added ".fd"-files to "Programmers/fd", which might be useful
  156.         for Basic programmers (".bmap" generation) or for generating
  157.         Link-Libraries
  158.       - last not least : I'm now reachable via EMail
  159.         (Fido : 2:2457/245.10)
  160.  
  161.  
  162.      V1.5 (17.05.1994) :
  163.      -------------------
  164.  
  165.       - use of SAS/C V6.51
  166.       - strongly improved ST.spobject
  167.  
  168.  
  169.      V1.4 (30.04.1994) :
  170.      -------------------
  171.  
  172.       - now WAV.spobject is really DEBUGGED and WORKS, which it
  173.         actually was not and did not before ;<
  174.       - also improved the other SPObjects a lot
  175.  
  176.  
  177.      V1.3 (30.3.1994) :
  178.      ------------------
  179.  
  180.       - added WAV.spobject to the distribution
  181.       - the new ST.spobject is now freely available as one of the supplied
  182.         Example-SPObjects
  183.       - improved Example-Programs : e.g. removed dependeny on ak_gen0.library
  184.       - removed some garbage from the header-files
  185.       - replaced SAS/C's sprintf()-routine with own, RawDoFmt()-based one.
  186.         This increases codesize a little bit, because sprintf() wasn't
  187.         actually used yet. This might come in the future.
  188.       - now using Utility-Library for integer operations (activated
  189.         SAS/C's UTILLIB option) : this increases 68000-codesize a little
  190.         bit, but increases speed on 68020+ systems
  191.         (should also decrease codesize, but does not ...)
  192.  
  193.  
  194.      V1.2 (27.2.1994) :
  195.      ------------------
  196.  
  197.       - recompilation : use of SAS/C V6.5.
  198.       - Parameter-BugFix in SVO_SetWriteSubType() :
  199.         pragmas put it into D1 instead of A2
  200.       - fixed small bug in the memory management routines
  201.  
  202.  
  203.      V1.1 :
  204.      ------
  205.  
  206.       - First Version. FREEWARE.
  207.  
  208.  
  209.     Copyrights :
  210.     ============
  211.  
  212.     Some of the mentioned names or products above may be copyrighted by
  213.     companies or trademarks of companies.
  214.  
  215.  
  216.